OSC configuration changes For TomEE

Locating Configuration Files

There are two core OSC files that need to be placed locally on the machines hosting the OIPA application. (Places the files inside the externallibs/pas_shared folder):

• osc.properties

• service-registry.xml.

For TomEE, the service-registry.xml file needs to be changed as TomEE uses ActiveMQ internally for messaging Queues. For more details related to initial setup refer OIPA OSC Installation guide. Once the service-registry.xml file is configured, place the file inside the externallibs/pas_shared/OSC/Properties folder.

Container Location for the Properties folder is /usr/local/tomee/externallibs/pas_shared/OSC/Properties/

Document Generator (Additional Changes)

Refer to the 12.2.0.0 OIPA Document Generator for the document generation feature.

Required Libraries

OIPA expects crystal runtime libraries for Document Generator functionality. Below listed libraries from crjava-runtime_12.2.219.zip must be placed in the class loader of the application server. Each of these files is included with Crystal Reports and not included with OIPA.

Copy the CR libraries into the pas_shared\cr_libs directory of TomEE:

commons-collections-3.2.2.jar	commons-configuration-1.2.jar	commons-logging.jar	commons-lang-2.1.jar
CrystalCommon2.jar	CrystalReportsRuntime.jar	DatabaseConnectors.jar
logging.jar	icu4j.jar	JDBInterface.jar	keycodeDecoder.jar
log4j-api.jar	log4j-core.jar	com.azalea.ufl.barcode.1.0.jar

The catalina.properties file in the scripts folder needs to be modified so as to make the TomEE container pick custom configurations or CR jars defined by the user.

Application shared/lib folders

shared.loader=${catalina.home}/externallibs/pas_shared/lib,${catalina.home}/externallibs/pas_shared/lib/*.jar,${catalina.home}/externallibs/pas_shared/cr_libs/*.jar,${catalina.home}/externallibs/pas_shared/conf

Continuing the same file we need to mention the coherence jar not to be scanned using Jar Scanner functionality. To achieve this in the same catalina.properties file, find the tomcat.util.scan.StandardJarScanFilter.jarsToSkip=\ and add coherence*.jar and pdq*.jar.

Note: To solve the DB2 latest Jar issues that comes with software, we need to mention the pdq.jar not be scaaned using Jar Scanner funcationality.

tomcat.util.scan.StandardJarScanFilter.jarsToSkip=\

--

--

coherence*.jar,\

--

pdq*.jar,\

--

These configurations are same for any instance of TomEE.

Set Environment Variables - TomEE

• For Windows deployment we need to create setenv.bat file in the bin folder of extracted TomEE directory.

• For Linux deployment we need to create setenv.sh file in the bin folder of extracted TomEE directory.

The following configuration needs to be placed in the setenv.bat file for Windows environment

Classpath

set CATALINA_OPTS=-Xms128m -Xmx1024m -XX:+UseG1GC

-Dtangosol.coherence.cacheconfig="C:/<Server Path>/shared/conf/coherence-cache-config.xml"

-Dtangosol.pof.config=com-adminserver-pas-web-pof-config.xml

-Dtangosol.coherence.override="C:/<Server Path>/shared/conf/coherence-config.xml"

-Dtangosol.coherence.distributed.localstorage=true

-Djava.naming.factory.initial=org.apache.activemq.jndi.ActiveMQInitialContextFactory

-Dtangosol.coherence.mode=prod

-Djava.util.logging.config.file="C:/<Server Path>/shared/conf/logging.properties"

-Dserver.name="<Name of the server>"

set OIPA_KEYSTORE_PWD=changeit

For Linux env in setenv.sh

Classpath

export CATALINA_OPTS="-Xms128m -Xmx1024m -XX:+UseG1GC

-Dtangosol.coherence.cacheconfig=/Servers/TomEE/OIPAInstance/shared/conf/coherence-cache-config.xml

-Dtangosol.pof.config=com-adminserver-pas-web-pof-config.xml

-Dtangosol.coherence.override=/Servers/TomEE/OIPAInstance/shared/conf/coherence-config.xml

-Dtangosol.coherence.distributed.localstorage=true -Dtangosol.coherence.mode=prod

-Djava.util.logging.config.file=/Servers/TomEE/OIPAInstance/shared/conf/logging.properties

-Djava.naming.factory.initial=org.apache.activemq.jndi.ActiveMQInitialContextFactory

-Dserver.name=<Name of the server>" export OIPA_KEYSTORE_PWD="changeit"